Skip to main content
POST
/
sdk
/
{environmentId}
/
externalAuth
/
verify
[DEPRECATED] Please use /externalAuth/signin instead
curl --request POST \
  --url https://app.dynamicauth.com/api/v0/sdk/{environmentId}/externalAuth/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "jwt": "jwt_value",
  "sessionPublicKey": "An example name"
}'
{
  "error": "Resources already exists for this Object",
  "code": "email_already_exists",
  "payload": {
    "email": "joe@email.com",
    "loginProvider": "emailOnly",
    "embeddedWalletName": "<string>",
    "embeddedSocialSigninProvider": "emailOnly",
    "mergeConflicts": {
      "fromUser": {
        "id": "95b11417-f18f-457f-8804-68e361f9164f",
        "projectEnvironmentId": "95b11417-f18f-457f-8804-68e361f9164f",
        "verifiedCredentials": [
          {
            "address": "0xbF394748301603f18d953C90F0b087CBEC0E1834",
            "chain": "<string>",
            "refId": "95b11417-f18f-457f-8804-68e361f9164f",
            "signerRefId": "95b11417-f18f-457f-8804-68e361f9164f",
            "email": "jsmith@example.com",
            "id": "95b11417-f18f-457f-8804-68e361f9164f",
            "name_service": {
              "avatar": "<string>",
              "name": "<string>"
            },
            "public_identifier": "<string>",
            "wallet_name": "<string>",
            "wallet_provider": "browserExtension",
            "wallet_properties": {
              "turnkeySubOrganizationId": "95b11417-f18f-457f-8804-68e361f9164f",
              "turnkeyPrivateKeyId": "95b11417-f18f-457f-8804-68e361f9164f",
              "turnkeyHDWalletId": "95b11417-f18f-457f-8804-68e361f9164f",
              "isAuthenticatorAttached": true,
              "turnkeyUserId": "95b11417-f18f-457f-8804-68e361f9164f",
              "isSessionKeyCompatible": true,
              "version": "V1",
              "ecdsaProviderType": "zerodev_signer_to_ecdsa",
              "entryPointVersion": "v6",
              "kernelVersion": "v2_4"
            },
            "format": "blockchain",
            "oauth_provider": "emailOnly",
            "oauth_username": "<string>",
            "oauth_display_name": "<string>",
            "oauth_account_id": "<string>",
            "phoneNumber": "9171113333",
            "phoneCountryCode": "1",
            "isoCountryCode": "US",
            "oauth_account_photos": [
              "<string>"
            ],
            "oauth_emails": [
              "<string>"
            ],
            "oauth_metadata": {},
            "previous_users": [
              "95b11417-f18f-457f-8804-68e361f9164f"
            ],
            "embedded_wallet_id": "<string>",
            "wallet_additional_addresses": [
              {
                "address": "<string>",
                "publicKey": "<string>",
                "type": "ordinals"
              }
            ],
            "lastSelectedAt": "2023-11-07T05:31:56Z",
            "signInEnabled": true
          }
        ],
        "lastVerifiedCredentialId": "95b11417-f18f-457f-8804-68e361f9164f",
        "sessionId": "95b11417-f18f-457f-8804-68e361f9164f",
        "alias": "An example name",
        "country": "US",
        "email": "jsmith@example.com",
        "firstName": "An example name",
        "jobTitle": "An example name",
        "lastName": "An example name",
        "phoneNumber": "<string>",
        "policiesConsent": true,
        "tShirtSize": "An example name",
        "team": "An example name",
        "username": "An example name",
        "firstVisit": "2023-11-07T05:31:56Z",
        "lastVisit": "2023-11-07T05:31:56Z",
        "newUser": true,
        "metadata": {},
        "mfaBackupCodeAcknowledgement": "pending",
        "btcWallet": "<string>",
        "kdaWallet": "<string>",
        "ltcWallet": "<string>",
        "ckbWallet": "<string>",
        "kasWallet": "<string>",
        "dogeWallet": "<string>",
        "emailNotification": true,
        "discordNotification": true,
        "newsletterNotification": true,
        "lists": [
          "<string>"
        ],
        "scope": "superuser marketing operations",
        "missingFields": [
          {
            "name": "<string>",
            "required": true,
            "enabled": true,
            "unique": true,
            "verify": true,
            "type": "standard",
            "validationRules": {
              "unique": true,
              "regex": "^0x",
              "validOptions": [
                {
                  "label": "small"
                },
                {
                  "label": "medium"
                },
                {
                  "label": "large"
                }
              ],
              "checkboxText": "Agree to the terms and conditions"
            },
            "validationType": "text",
            "label": "<string>",
            "position": 123
          }
        ]
      },
      "conflicts": [
        {
          "field": {
            "name": "<string>",
            "required": true,
            "enabled": true,
            "unique": true,
            "verify": true,
            "type": "standard",
            "validationRules": {
              "unique": true,
              "regex": "^0x",
              "validOptions": [
                {
                  "label": "small"
                },
                {
                  "label": "medium"
                },
                {
                  "label": "large"
                }
              ],
              "checkboxText": "Agree to the terms and conditions"
            },
            "validationType": "text",
            "label": "<string>",
            "position": 123
          },
          "fromUser": {
            "userId": "95b11417-f18f-457f-8804-68e361f9164f",
            "value": "An example name"
          },
          "currentUser": {
            "userId": "95b11417-f18f-457f-8804-68e361f9164f",
            "value": "An example name"
          }
        }
      ]
    },
    "additionalMessages": [
      "<string>"
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
environmentId
string
required

ID of the environment

Required string length: 36
Example:

"95b11417-f18f-457f-8804-68e361f9164f"

Body

application/json
​
jwt
string

Encoded JWT token. This will only be returned when cookie-based authentication is disabled in favor of standard Auth header based authentication.

Example:

"jwt_value"

​
sessionPublicKey
string
Example:

"An example name"

Response

Unprocessable Entity

​
error
string
required
Example:

"Resources already exists for this Object"

​
code
enum<string>
Available options:
email_already_exists,
allowlist_already_exists,
allowlist_entry_already_exists,
reassign_wallet_error,
reassign_wallet_confirm,
members_cannot_delete_themself,
username_already_exists,
wrong_email_verification_token,
wrong_sms_verification_token,
invalid_email_verification,
invalid_sms_verification,
invalid_verification,
invalid_position,
too_many_sms_verification_attempts,
too_many_email_verification_attempts,
too_many_verification_attempts,
organization_name_already_exists,
project_name_already_exists,
wallet_not_deployed,
email_verification_required,
phone_verification_required,
invite_address_required,
provider_not_available,
forbidden_unlink_request,
invalid_unlink_request,
too_many_api_tokens,
lock_timeout,
lock_too_many_attempts,
nft_token_gating_not_supported_for_chain,
empty_chain_name,
no_enabled_email_provider,
no_enabled_sms_provider,
invalid_key_export_url,
invalid_dynamic_props,
too_many_requests,
too_many_organizations_for_user,
too_many_projects_for_organization,
email_associated_with_different_provider,
user_has_already_account_with_email,
user_has_already_account_with_phone_number,
other_verify_failure,
email_tied_to_embedded_wallet,
invalid_invite,
social_account_already_exists,
invalid_email_address,
invalid_gate,
conflicting_embedded_wallet_providers,
invalid_user,
invalid_cors_origins,
invalid_mobile_deeplink_urls,
unauthorized_mobile_deeplink_url,
invalid_private_key_format,
invalid_embedded_wallet_settings,
wallet_not_support_passkey,
recovery_email_unavailable_or_invalid,
connect_error,
invalid_wallet_name,
invalid_wallet_address,
email_recovery_disabled,
no_compatible_wallet_service_enabled,
missing_aa_project_id,
linked_embedded_wallet,
invalid_mpc_environment,
invalid_regex,
repeated_options,
missing_phone_number_or_email,
duplicate_exists,
mfa_device_not_found,
mfa_invalid_code,
mfa_invalid_request,
invalid_phone,
gate_exists,
invalid_embedded_wallet_chains_configuration,
merge_accounts_confirmation,
merge_accounts_invalid,
invalid_wallet_id,
unable_to_fetch_balances,
cannot_switch_to_unique,
custom_field_data_not_unique,
metadata_size_exceeded,
invalid_custom_hostname,
blocked_user_cannot_transfer_wallet,
feature_not_enabled_in_suborg,
invalid_username,
invalid_external_auth,
invalid_chain_address_match,
invalid_update,
cannot_delete_last_project,
no_hd_wallet_found,
wallet_account_exists_for_chain,
too_many_embedded_wallets_for_user,
too_many_embedded_wallets_per_chain_for_user,
invalid_session_public_key,
custom_field_not_unique,
invalid_aa_project_configuration,
no_v1_embedded_wallet_found,
embedded_wallet_address_already_linked,
key_share_already_backed_up,
invalid_key_shares_length
​
payload
object

Contains information which the integrating client of this API can use to tailor an experience to a customer to fix the underlying issue that triggered this error.